package com.shortLinked.project.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.shortLinked.project.dto.req.ShortLinkGroupStatsAccessRecordReqDTO;
import com.shortLinked.project.dto.req.ShortLinkGroupStatsReqDTO;
import com.shortLinked.project.dto.req.ShortLinkStatsAccessRecordReqDTO;
import com.shortLinked.project.dto.req.ShortLinkStatsReqDTO;
import com.shortLinked.project.dto.resp.ShortLinkStatsAccessRecordRespDTO;
import com.shortLinked.project.dto.resp.ShortLinkStatsRespDTO;

/**
 * 短链接监控接口层
 */
public interface ShortLinkStatsService {

    /**
     * 单个短链接监控
     *
     * @param requestParam 单个短链接请求参数
     * @return 单个短链接监控返回参数
     */
    ShortLinkStatsRespDTO oneShortLinkStats(ShortLinkStatsReqDTO requestParam);

    /**
     * 访问单个短链接指定时间内访问记录监控统计数据
     *
     * @param requestParam 单个短链接访问请求参数
     * @return 短链接指定时间内访问记录详情
     */
    IPage<ShortLinkStatsAccessRecordRespDTO> shortLinkStatsAccessRecord(ShortLinkStatsAccessRecordReqDTO requestParam);

    /**
     * 访问分组短链接指定日期内访问记录监控统计详情
     *
     * @param requestParam 分组短链接请求入参
     * @return 分组短链接统计详情
     */
    ShortLinkStatsRespDTO groupShortLinkStats(ShortLinkGroupStatsReqDTO requestParam);

    /**
     * 指定分组短链接指定日期访问统计记录详情
     *
     * @param requestParam 指定分组短链接请求入参
     * @return 分组短链接统计详情
     */
    IPage<ShortLinkStatsAccessRecordRespDTO> groupShortLinkStatsAccessRecord(ShortLinkGroupStatsAccessRecordReqDTO requestParam);
}
